home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1998 July / EnigmA AMIGA RUN 29 (1998)(G.R. Edizioni)(IT)[!][issue 1998-07 & 08].iso / recent / bencht.lha / BenchTrash / Extras / Park.readme < prev    next >
Text File  |  1998-06-06  |  5KB  |  154 lines
  1. Short:    Park HD units
  2. Uploader: thor@math.tu-berlin.de (Thomas Richter)
  3. Author:   thor@math.tu-berlin.de (Thomas Richter)
  4. Type:     disk/misc    
  5. Version:  1.02
  6. Requires: Os 2.04
  7.  
  8. This tool parks or restarts a HD unit, either given by its DOS device name
  9. or the name and unit of the exec device driver. All partitions on the
  10. parked unit will be unaccessible to the dos afterwards. To be able to
  11. restart the HD, "Park" can be made resident.
  12. _____________________________________________________________________________
  13.  
  14. Version 1.02:
  15.  
  16. Park checks now if a device is already parked (or, to be precise, if the
  17. filing system is shut down) and fails if the user tries to park it again.
  18. _____________________________________________________________________________
  19.  
  20. Version 1.01:
  21.  
  22. Added an explicit check whether the handler name supplied does really contain
  23. a colon.
  24. _____________________________________________________________________________
  25.  
  26. Synopsis:
  27.  
  28. Park HANDLER,DEVICE/K,UNIT/N,FLAGS/N,SCSI/S,ON=START/S
  29.  
  30.  
  31. HANDLER:    DOS Device name to be parked, or name of the volume. To 
  32.         restart a unit, this must be the device name.
  33.         This *must* be the name of the dos device driver, i.e.
  34.         a string like "DH0:" or "SYS:".
  35.         
  36. DEVICE:        Alternatively the name of the exec.device, if HANDLER is
  37.         not available. The keyword "DEVICE" must be used for that
  38.         purpose.
  39.         If you DO NOT use the "DEVICE" keyword, the dos.library
  40.         will assign your argument to the "HANDLER" keyword, not
  41.         to this one. Thus, to say that again, IT'S VERY IMPORTANT
  42.         to use the keyword to make this available.
  43.  
  44. UNIT:        The unit number of the exec device. Makes only sense if
  45.         DEVICE keyword is used.
  46.  
  47. FLAGS:        The flags for opening the device. Defaults to zero and is
  48.         usually not required.
  49.  
  50. SCSI:        If given, try to park the unit with direct SCSI commands.
  51.         This should work with all scsi.device compatible device
  52.         drivers.
  53.         If not given, try to use the CMD_START and CMD_STOP.
  54.  
  55.         Unfortunately, most device drivers do not support 
  56.         CMD_START/STOP. The "SCSI" keyword is therefore almost
  57.         always required.
  58.  
  59. ON=START:    Restart the device and the partitions in question.
  60.  
  61. _____________________________________________________________________________
  62.  
  63. Examples:
  64.  
  65. Park all partitions on the oktagon.device, unit 2: 
  66. (The oktagon knowns CMD_STOP, SCSI is not required)
  67.  
  68.     Park device oktagon.device unit 2
  69.  
  70.  
  71. Park all partitions on the gvpscsi.device, unit 6:
  72. (The gvpscsi.device does NOT know the CMD_STOP, SCSI is required)
  73.  
  74.     Park device gvpscsi.device unit 6 scsi
  75.  
  76. The "device" keyword is very important in both cases.
  77.  
  78.  
  79. Park the partition DH0: and all other partitions on the same device:
  80.  
  81.     Park DH0: scsi
  82.  
  83.  
  84. Restart DH0: and all other partitions on that device:
  85.  
  86.     Park DH0: on scsi
  87.  
  88. _____________________________________________________________________________
  89.  
  90.  
  91.                         The THOR-Software Licence
  92.  
  93.  
  94. This License applies to the computer programs known as "Park".
  95. The "Program", below, refers to such program.
  96.  
  97.  
  98. The programs and files in this distribution are freely distributable
  99. under the restrictions stated below, but are also Copyright (c)
  100. Thomas Richter.
  101.  
  102.  
  103. Distribution of the Program by a commercial organization without written
  104. permission from the author to any third party is prohibited if any payment
  105. is made in connection with such distribution, whether directly
  106. (as in payment for a copy of the Program) or indirectly (as in payment
  107. for some service related to the Program, or payment for some product
  108. or service that includes a copy of the Program "without charge";
  109. these are only examples, and not an exhaustive enumeration of prohibited
  110. activities). However, the following methods of distribution involving
  111. payment shall not in and of themselves be a violation of this restriction:
  112.  
  113.  
  114. (i) Posting the Program on a public access information storage and
  115. retrieval service for which a fee is received for retrieving information
  116. (such as an on-line service), provided that the fee is not
  117. content-dependent (i.e., the fee would be the same for retrieving the same
  118. volume of information consisting of random data).
  119.  
  120.  
  121.  
  122. (ii) Distributing the Program on a CD-ROM, provided that the files
  123. containing the Program are reproduced entirely and verbatim on such
  124. CD-ROM, and provided further that all information on such CD-ROM be
  125. redistributable for non-commercial purposes without charge.
  126.  
  127.  
  128.  
  129. Everything in this distribution must be kept together, in original
  130. and unmodified form.
  131.  
  132.  
  133.  
  134.  
  135. Limitations.
  136.  
  137. THE PROGRAM IS PROVIDED TO YOU "AS IS," WITHOUT WARRANTY. THERE IS NO
  138. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  139. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  140. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  141. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  142. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  143. SERVICING, REPAIR OR CORRECTION.
  144.  
  145.  
  146.  
  147. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE ALL FILES CONTAINED IN
  148. THIS ARCHIVE.
  149.  
  150. _____________________________________________________________________________
  151.  
  152. Thomas,        
  153.     May 1998
  154.